home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / utility / 533 / mcp / mcp.doc next >
Encoding:
Text File  |  1991-05-14  |  7.3 KB  |  181 lines
  1. mcp - copy files
  2. Version 1.0, Copyright (c) 1991, Monk Software
  3.  
  4. General Idea:
  5.  
  6.     Mcp is a directory-oriented copy program.  It gives you better
  7.     control over which files you can copy or move.  In the simplest
  8.     case, all files are copied from the source directory to the target
  9.     directory.  A list of files can be specified to limit what is
  10.     copied.  This list can have wild-card file specifications (default
  11.     list = *.*) and may be applied against either the source or target
  12.     directory (default = source).  File dates and times can be used to
  13.     limit the file list.  Recursive copies are also supported.
  14.  
  15. Usage:
  16.  
  17.     mcp [-abcdfghimnorstvw?] source_dir target_dir [file_list]
  18.  
  19. Options:
  20.  
  21.     -a - All
  22.         Copy all files in the file list without regard to file date or
  23.         time.  This is the default.  The alternative is to use the -n,
  24.         -o, -d, or, -w options.
  25.  
  26.     -b - Create target dir
  27.         Create target directory if it does not exist.  Normally mcp
  28.         will prompt the user to decide whether to create the target
  29.         directory.  This option makes it easier to run mcp from a
  30.         batch or script file.
  31.  
  32.     -c - Check
  33.         Check the operation of the mcp command without actually
  34.         copying any files.  This mode sets the verbose options.
  35.  
  36.     -d [boa]mm/dd/yy - Date
  37.         Copy files based on the date that they were last changed.
  38.         This flag takes one argument starting with the letters 'b',
  39.         'o', or 'a', followed by the date in the form, mm/dd/yy.  The
  40.         prefix 'b' stands for 'before' but not including the specified
  41.         date.  The prefix 'o' stands for 'on' the specified date, and
  42.         'a' stands for 'after' the specified date.  The date ranges
  43.         specified using the 'a' and 'b' prefixes are 'and-ed'
  44.         together.  The 'o' dates are then 'or-ed' with the result.
  45.         For example to specify all files last-changed during March,
  46.         you could type:
  47.             mcp -vd ao3/1/91 -d b4/1/91 . a:
  48.  
  49.     -f file_name - File
  50.         Get the file list from the file which is specified as an
  51.         argument following the -f flag.  If the file_name is '-' then
  52.         the file list will come from standard input.
  53.  
  54.     -g - Gather
  55.         Gather the files from the source directory and all its
  56.         subdirectories into the one target directory.
  57.  
  58.     -h - Hidden
  59.         Copy hidden files as well as non-hidden files.
  60.  
  61.     -i - Interactive
  62.         Interactively ask the user if he wishes to copy each file,
  63.         before the copy occurs.
  64.  
  65.     -m - Move
  66.         Removes all copied files from the source directory.
  67.  
  68.     -n - Newer
  69.         Copy only newer files.  If the source file already has a copy
  70.         in the target directory, then the copy or move only occurs if
  71.         the source file has a later date/time stamp then the target
  72.         copy.  If a source file does not already exist in the target
  73.         directory, then the source file is copied. This option can be
  74.         handy for doing fast backups.
  75.  
  76.     -o - Older
  77.         Copy only older files.  If the source file already has a copy
  78.         in the target directory, then the copy or move only occurs if
  79.         the source file has an earlier date/time stamp then the target
  80.         copy.  If a source file does not already exist in the target
  81.         directory, then the source file is copied. This option can be
  82.         handy for quickly restoring backups.
  83.  
  84.     -no - Not On target
  85.         Copy only if the source file does not exist in the target
  86.         directory.  This is a trick that uses the 'n' and 'o' options.
  87.  
  88.     -r - Recursive
  89.         Recursively copy all of the subdirectories of the source
  90.         directory.  Subdirectories that don't already exist under the
  91.         target directory are created.
  92.  
  93.     -s - Source
  94.         Apply the file list to the source directory. This is the
  95.         default.  The alternative is -t.
  96.  
  97.     -t - Target
  98.         Apply the file list to the target directory. For example,
  99.         typing 'mcp -t . a:', would copy only those files in the
  100.         current directory which were already on the 'A' drive.  This
  101.         is handy for doing backups.
  102.  
  103.     -v - Verbose
  104.         Report all files that are copied or moved.
  105.  
  106.     -vv - Very Verbose
  107.         Report all files that are copied or not copied.
  108.  
  109.     -w [ba]hh:mm[pa] - When
  110.         Copy files based on the time that they were last changed.
  111.         This flag takes one argument starting with the letters 'b', or
  112.         'a', followed by the time in the form, hh:mm[ap].  The prefix
  113.         'b' stands for 'before' but not including the specified time.
  114.         and the prefix 'a' stands for 'after' the specified date.  The
  115.         time ranges specified using the 'a' and 'b' prefixes are
  116.         'and-ed' together.  For example to specify all files
  117.         last-changed after 10:00pm but before 11:00pm you could type:
  118.             mcp -vt a10:00p -t b11:00p . a:
  119.         If this option is used without the date option, then the
  120.         current system date is assumed.
  121.  
  122.     -?
  123.         Print full documentation and exit.  You are here!
  124.  
  125. Disk Overflow:
  126.  
  127.     If the destination drive is full during a copy, then mcp will
  128.     pause and allow the user to change diskettes.  If the user
  129.     specified -o, -n, or -t then she will not be able to change
  130.     floppies.  This is because the original floppy was used to
  131.     determine which files to copy.
  132.  
  133. File List:
  134.  
  135.     If not specified, the default file list is '*.*'.  Any files
  136.     prefixed with '-' will be excluded from the file list.  For
  137.     example, to copy all files in a directory except a file called
  138.     'junk' or those with a '.obj' suffix, you could type:
  139.         mcp -v . a: *.* -junk -*.obj
  140.     or
  141.         mcp -v . a: -junk -*.obj
  142.  
  143.     To copy a file starting with '-', use a prefix of '\'.  For
  144.     example, to copy a file named '-copy.me', you could type:
  145.         mcp -v . a: \-copy.me
  146.  
  147.     On a recursive copy, the file list is applied recursively to the
  148.     source or target (with -t option) directory and all
  149.     subdirectories.
  150.  
  151. Nonexistent Target Directory:
  152.  
  153.     If the target directory does not exist, either the user will be
  154.     asked if she wishes to create it or, if the -b option is
  155.     specified, it will be created automatically.
  156.  
  157. License:
  158.  
  159.     This program is shareware.  You are encouraged to try it out, and,
  160.     if you like it, to give it to friends and upload it to BBS's and
  161.     archive sites.  We request a $10 fee to register this program.
  162.     When you register, you are supporting us and, in return, we will
  163.     support you.  We hope to bring you more high-quality, low-cost
  164.     software in the future.
  165.  
  166.     To protect ourselves, we must say that we will not be liable for
  167.     any damages resulting from use or abuse of this program.  You use
  168.     'mcp' at your own risk.  However, we strive to make the quality of
  169.     our programs high.  Please report any bugs you find and we will
  170.     gladly fix them and send you an update.
  171.  
  172.     Please send registration fees and/or suggestions to:
  173.         Monk Software
  174.         2464 El Camino Real, #404
  175.         Santa Clara, CA 95051
  176.     Include the name of the program, operating system, and disk size.
  177.  
  178.     Bug reports and other comments can also be sent by e-mail on the
  179.         Internet to : monk@netcom.com
  180.         UUCP: uunet!apple!netcom!monk
  181.